Programming with QuickTime VR

QTVRMouseUpExtended

You can use the QTVRMouseUpExtended function the same way you use the QTVRMouseUp function, to handle the user's releasing the mouse button while the cursor is in a QuickTime VR movie for which mouse-down tracking is disabled. The QTVRMouseUpExtended function uses the same intercept as the QTVRMouseUp function but has has two additional parameters.

Internally, QuickTime VR always uses the QTVRMouseUpExtended function instead of QTVRMouseUp . Developers implementing their own mouse down tracking don't need to use the extended version unless they also intercept the procedure and need the added parameters.



 
OSErr QTVRMouseUpExtended (

                     QTVRInstance qtvr, 

                     Pointpt, 

                     UInt32*hotSpotID, 

                     WindowPtr w, 

                     UInt32 when, 

                     UInt16 modifiers);

qtvr: An instance of a QuickTime VR movie.
pt: The current location of the cursor, in the local coordinates of the graphics world specified by the w parameter.
hotSpotID: On entry, a pointer to a long integer. On exit, that long integer contains the ID of the hot spot that lies beneath the specified point, or the value 0 if no hot spot lies beneath that point.
w: A pointer to a graphics world.
when: The time, in the number of ticks since system startup, when the mouse-up event was posted.
modifiers: A short integer that contains information about the state of the modifier keys and the mouse button at the time the event was posted. See the chapter "Event Manager" in Inside Macintosh: Macintosh Toolbox Essentials for a description of the information encoded in this parameter.
function result: A result code.

DESCRIPTION

The QTVRMouseUpExtended function returns, in the long integer pointed to by the hotSpotID parameter, the ID of the hot spot in the QuickTime VR movie specified by the qtvr parameter that lies directly under the point specified by the pt parameter. If no hot spot lies under that point, the long integer is set to 0. QTVRMouseUpExtended also performs any other tasks that are typically performed when the user releases the mouse button after clicking it when the cursor is in a QuickTime VR movie.

SPECIAL CONSIDERATIONS

You need to call QTVRMouseUp or QTVRMouseUpExtended only if you have disabled mouse-down tracking for the specified QuickTime VR movie.